home *** CD-ROM | disk | FTP | other *** search
/ Mac Format 1994 October / Macformat17.cdr / Shareware City / Developers / Think C dcmd 1.0 ƒ / Read me first ! next >
Text File  |  1994-06-19  |  5KB  |  106 lines
  1.    **********************
  2.    *  Think C dcmd 1.0  *
  3.    **********************
  4.  
  5.    Written by P. Stadelmann, June 1994.
  6.  
  7. •• Introduction ••
  8.  
  9.    This package allows you to write dcmds in Think C. It contains the glue code
  10.    necessary to link the "dcmd.o" library, and Think Put, a collection of routines
  11.    to create formatted output in dcmds.
  12.    
  13.  
  14. •• How to use (Think C 7.0 or later) ••
  15.  
  16.    The following applies to Think C 7.0 or later. If you use an earlier version
  17.    of Think C, please refer to "How to use (Think C 6.0.x or earlier)"
  18.  
  19. 1) Put the files "Think_dcmd.h", "Think_put.h", "Think dcmd glue" and "Think Put Lib"
  20.    where the Project Manager can find them (like in the "Mac Librairies" and
  21.    "Mac #includes" folders).
  22.  
  23. 2) Do the same with the files "dcmd.h" and "dcmdGlue.a.o". These files are available
  24.    along with MacsBug from ftp.apple.com in the dts/mac/tools/macsbug/ directory.
  25.  
  26. 3) Drop the folder named "Think dcmd" into the (Project Models) folder.
  27.    
  28. 4) In the Project Manager, create a new project. Choose "Think dcmd" in project list.
  29.    Add your code in the dcmd.c file : write the CommandEntry code as described in 
  30.    chapter 8 of the book "MacsBug Reference and Debugging Reference" from
  31.    Apple Computer, Inc.
  32.  
  33. 5) Use the "Set Project Type" command to choose the name and id of your dcmd. Remember
  34.    that the dcmd name (used to run the dcmd in MacsBug) is the name of the dcmd resource.
  35.  
  36. 6) Once you have built the dcmd, use a resource editor to copy the dcmd into the
  37.    "Debugger Prefs" file inside your system folder.
  38.    
  39.  
  40. •• How to use (Think C 6.0.x or earlier) ••
  41.  
  42. 1) Delete the "Think dcmd glue" and "Think Put Lib" project files, because they can
  43.    only be used with Think C 7.0 or later.
  44.  
  45. 2) Create an empty project named "Think dcmd glue". Add the file "Think dcmd glue.c"
  46.    from the "Think dcmd glue source" folder to the project. Set the project type to
  47.    "Code resource". Bring the project up to date.
  48.  
  49. 3) Create an empty project named "Think Put Lib". Add all the files from the
  50.    "Think Put Lib source" folder to the project. Set the project type to
  51.    "Code resource". Bring the project up to date.
  52.  
  53. 4) Put the files "Think_dcmd.h", "Think_put.h", "Think dcmd glue" and "Think Put Lib"
  54.    where the Project Manager can find them (like in the "Mac Librairies" and
  55.    "Mac #includes" folders).
  56.  
  57. 5) Do the same with the files "dcmd.h" and "dcmdGlue.a.o". These files are available
  58.    along with MacsBug from ftp.apple.com in the dts/mac/tools/macsbug/ directory.
  59.    
  60.    If you have Think C 5.0.x or earlier, convert the "dcmdGlue.a.o" library into 
  61.    an A4-based project with the "oConv" application.
  62.  
  63. 6) Create a new project. Add the "dcdmGlue.a.o" library (or the corresponding
  64.    converted project file), the "Think dcmd glue" file and a copy of the "dcmd.c" file
  65.    to your project. Add your code in the dcmd.c file : write the CommandEntry code as
  66.    described in chapter 8 of the book "MacsBug Reference and Debugging Reference"
  67.    from Apple Computer, Inc.
  68.  
  69. 5) Using the "Set Project Type" command, set the project type to "Code resource", the
  70.    type to 'dcmd'. Choose the name and id of your dcmd. Remember that the dcmd name
  71.    (used to run the dcmd in MacsBug) is the name of the dcmd resource. Set the file
  72.    type to 'rsrc' and the creator to 'RSED'.
  73.    
  74.    VERY IMPORTANT : Check the "Custom header" checkbox.   
  75.  
  76. 6) Once you have built the dcmd, use a resource editor to copy the dcmd into the
  77.    "Debugger Prefs" file inside your system folder.
  78.  
  79.  
  80. •• Notes ••
  81.  
  82.  ◊ In Think C 7.0 or later, execute step 1-3 only once. For each new dcmd you want
  83.    to write, start at step 4.
  84.    
  85.  ◊ In Think C 6.0.x or earlier, execute step 1-5 only once. For each new dcmd you want
  86.    to write, start at step 6.
  87.    
  88.  ◊ If you want to use global variables, #include <SetUpA4.h> in the begining of the
  89.    dcmd.c file. Call RememmberA0() and SetUpA4() in the begining of the CommandEntry
  90.    procedure, and RestoreA4() in the end.
  91.  
  92.  ◊ To use the Think Put Library, add the "Think Put Lib" file to your project and
  93.    #include <Think_put.h> in the beginning of the dcmd.c file
  94.  
  95.  ◊ The Think Put Library in this package requires globals.
  96.  
  97.  
  98. •• About ••
  99.  
  100.    Written by P. Stadelmann <Patrick.Stadelmann@etudiants.unine.ch>.   
  101.    Feel free to contact me if you have comments, suggestions or bugs to report.
  102.    
  103.    Thanks to R. Wesley.
  104.    
  105.    This package is public domain. However, the "dcmd.h" and "dcmdGlue.a.o"
  106.    files are copyrighted material from Apple Computer, Inc.